顔パーツ補正検出タスクのステータスを確認します。

リクエスト

ソース画像に複数の有効なターゲットが含まれる可能性がある場合、またはエフェクトを適用する検出ターゲットを明示的に選びたい場合は、前処理タスクを使います。単一ターゲットの画像では、機能がデフォルトの index 値をサポートしているため、手動でのターゲット選択が不要な場合は前処理をスキップできます。

前処理タスクは、ソース画像内の候補ターゲットを検出し、その座標を data.results.result に返します。結果配列の各項目は、検出された 1 つのターゲットを表します。返された座標を確認し、ソース画像内の意図した顔や領域に対応づけたうえで、エフェクトタスクを作成する際にその項目のゼロベース配列インデックスを index 値として使います。

複数の顔や領域が検出された画像では、前処理の結果を確認せずにデフォルトの index 値に頼らないでください。エフェクトは index で選択されたターゲットにしか適用されないため、エフェクトタスクを実行する前に、意図したターゲットに対応する結果項目を確認する必要があります。

このタスクは非同期です。タスクを作成した後、機能がサポートしている場合は Webhook で完了を処理するか、対応する前処理ステータスエンドポイントをポーリングして data.task_status が success または error になるまで待ちます。

セキュリティ

BearerAuthenticationV2

パス

task_idstring必須

確認するタスクの ID

例:grH0CvsgXuAIHLUzD0V1Ol34hoet3R1tvdbtiVHrDb6_UqCLKIejAIajwxrhOAfe

curl -i -X GET \
  https://yce-api-01.makeupar.com/s2s/v2.0/task/face-reshape/pre-process/grH0CvsgXuAIHLUzD0V1Ol34hoet3R1tvdbtiVHrDb6_UqCLKIejAIajwxrhOAfe \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

レスポンス

タスクステータスの確認に成功しました

ボディapplication/json

statusinteger

レスポンスステータス

例:200

dataobject

レスポンス

{
  "status": 200,
  "data": {
    "task_status": "running",
    "error": "error_exceed_max_image_size",
    "error_message": "string",
    "results": { … }
  }
}